package com.ics.atable.chat.service;

import com.ics.atable.chat.model.dto.SqlReplaceDTO;
import com.ics.atable.chat.model.entity.DataCellWide;

import java.util.List;

/**
 * AI 解释服务接口
 *
 * @author system
 */
public interface AiExplanationService {

    /**
     * 使用 AI 生成查询结果的自然语言解释
     *
     * @param queryParams 查询参数
     * @param results 查询结果
     * @return AI 生成的自然语言解释
     */
    String generateExplanation(
            SqlReplaceDTO.QueryRequest.ReplaceParams queryParams,
            List<DataCellWide> results
    );

    /**
     * 检查 AI 服务是否可用
     *
     * @return true 如果 AI 服务可用
     */
    boolean isAiAvailable();
}
